/*
 * Copyright (c) 2018-2999 广州市蓝海创新科技有限公司 All rights reserved.
 *
 * https://www.mall4j.com/
 *
 * 未经允许，不可做商业用途！
 *
 * 版权所有，侵权必究！
 */

package com.yami.shop.service;

import com.yami.shop.bean.app.dto.ExpressQueryDto;
import com.yami.shop.bean.param.ExpressQueryParam;

/**
 * 快递100 API服务接口
 *
 * @author lgh
 */
public interface Express100Service {

    /**
     * 查询快递物流信息
     *
     * @param param 查询参数
     * @return 快递查询结果
     */
    ExpressQueryDto queryExpress(ExpressQueryParam param);

    /**
     * 根据快递公司编码和快递单号查询物流信息
     *
     * @param companyCode 快递公司编码
     * @param expressNo 快递单号
     * @return 快递查询结果
     */
    ExpressQueryDto queryExpress(String companyCode, String expressNo);

    /**
     * 根据快递公司编码、快递单号和手机号后四位查询物流信息
     *
     * @param companyCode 快递公司编码
     * @param expressNo 快递单号
     * @param phone 手机号后四位
     * @return 快递查询结果
     */
    ExpressQueryDto queryExpress(String companyCode, String expressNo, String phone);

    /**
     * 验证快递100服务是否可用
     *
     * @return 是否可用
     */
    boolean isServiceAvailable();
}